home *** CD-ROM | disk | FTP | other *** search
/ ASP Advantage 1993 / The Association of Shareware Professionals Advantage CD-ROM 1993.iso / files / commions / ca29_1 / ca29_3.exe / BBS.DOC < prev    next >
Text File  |  1992-11-30  |  44KB  |  1,595 lines
  1. COM-AND Scripted BBS
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.           ------------------------------------------
  13.                 COM-AND Scripted BBS
  14.           Script based Bulletin Board for the IBM PC
  15.           ------------------------------------------
  16.  
  17.  
  18.  
  19.  
  20.     COM-AND, and the BBS script-set (BBS, BBMAINT, et al) are copy-
  21.     right 1992 by CABER Software.  COM-AND is distributed freely and
  22.     may be copied by anyone for any number of machines, for purposes
  23.     of evaluation.    The author offers COM-AND and its accessory
  24.     programs as a package, as "shareware".  If you USE the program
  25.     after evaluating it, you MUST pay for it.
  26.  
  27.  
  28.     The complete user license and registration information is to be
  29.     found in the file REGISTER.DOC.  Limitations on redistribution
  30.     of COM-AND are set out in the file VENDOR.DOC.    These two files
  31.     are included with the COM-AND program release.
  32.  
  33.  
  34.  
  35.                  CABER Software
  36.                  R. (Scott) McGinnis
  37.                  P.O. Box 3607 Mdse Mart
  38.                  Chicago, IL 60654-0607
  39.  
  40.                  GEnie, Delphi: TARTAN
  41.                  CIS .......... 73147,2665
  42.                  Internet ..... 73147.2665@compuserve.com
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54. Version 1.2: 921012
  55.  
  56. COM-AND Scripted BBS
  57.  
  58.  
  59.  
  60.                  Table of Contents
  61.                  -----------------
  62.  
  63.  
  64. I.    Introduction  .............................................. page 1
  65.  
  66.     A. What is COM-AND? ........................................ page 1
  67.     B. The BBS script .......................................... page 1
  68.  
  69. II.    Installing the BBS ......................................... page 2
  70.  
  71.     A. Create a subdirectory \BBS .............................. page 2
  72.     B. Load BBSETUP ............................................ page 2
  73.     C. Use BBSETUP ............................................. page 3
  74.     D. Exit BBSETUP and load BBMAINT ........................... page 4
  75.     E. Execute BBS ............................................. page 5
  76.  
  77. III.    Logon ...................................................... page 6
  78.  
  79. IV.    Bulletins .................................................. page 7
  80.  
  81. V.    Mail ....................................................... page 8
  82.  
  83. VI.    Files (Upload and Download) ................................ page 9
  84.  
  85. VII.    Chat mode .................................................. page 11
  86.  
  87. VIII.    Privileged commands ........................................ page 12
  88.  
  89. IX.    Menu tree .................................................. page 13
  90.  
  91.     A. Connect ................................................. page 13
  92.     B. Logon ................................................... page 13
  93.     C. Main Menu ............................................... page 13
  94.     D. Privileged .............................................. page 16
  95.     E. Registration ............................................ page 16
  96.  
  97. X.    BBS-Log .................................................... page 17
  98.  
  99. XI.    Program Requirements ....................................... page 18
  100.  
  101. XII.    Program and Author Information    ............................ page 19
  102.  
  103. XIII.    Support EtCetera BBS........................................ page 20
  104.  
  105.  
  106.  
  107.  
  108.  
  109. Version 1.2: 921012
  110.  
  111. COM-AND Scripted BBS
  112.  
  113.  
  114.  
  115.                 Appendices
  116.                 ----------
  117.  
  118.  
  119. A.    Required and optional files ................................ page 21
  120.  
  121.     1. Required files in subdirectory \BBS ..................... page 21
  122.     2. Optional files in subdirectory \BBS ..................... page 21
  123.     3. Optional files in subdirectory \BBS\Bulletin ............ page 21
  124.     4. Optional files in subdirectory \BBS\Mail ................ page 21
  125.     5. Optional files in subdirectory \BBS\FILE ................ page 21
  126.  
  127. B.    File structures ............................................ page 22
  128.  
  129.     1. \BBS\BBS-USER ........................................... page 22
  130.     2. \BBS\Bulletin\BBS-BULL .................................. page 22
  131.     3. \BBS\Mail\BBS-MAIL ...................................... page 22
  132.     4. \BBS\FILE\BBS-FILE ...................................... page 22
  133.  
  134. C.    Maintenance ................................................ page 23
  135.  
  136.     1. Registrations ........................................... page 23
  137.     2. Mail .................................................... page 23
  138.     3. Bulletins ............................................... page 23
  139.     4. Files ................................................... page 23
  140.  
  141. D.    Modem configuration ........................................ page 24
  142.  
  143.     1. DTR ..................................................... page 24
  144.     2. CD ...................................................... page 24
  145.     3. Modem ESCAPE ............................................ page 25
  146.     4. Hangup .................................................. page 25
  147.     5. Modem Init .............................................. page 25
  148.     6. Other settings .......................................... page 25
  149.  
  150. E.    Sample files ............................................... page 26
  151.  
  152.     1. BBS-USER ................................................ page 26
  153.     2. BBS-BULL ................................................ page 26
  154.     3. BBS-MAIL ................................................ page 26
  155.     4. BBS-FILE ................................................ page 26
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164. Version 1.2: 921012
  165.  
  166. COM-AND Scripted BBS                             Page   1
  167.  
  168.  
  169. I.    Introduction
  170.  
  171.  
  172.     A. What is COM-AND?
  173.  
  174.  
  175.        COM-AND for the IBM PC and compatibles is a communications program
  176.        for use by itself, or for use with several integrated accessory
  177.        programs (which themselves may be used independently of COM-AND).
  178.        COM-AND provides standard comm program functions:  a dialing
  179.        directory, macros, disk logging, binary and ASCII file transfers,
  180.        scripted execution and so on.
  181.  
  182.  
  183.     B. The BBS script
  184.  
  185.  
  186.        This document details the BBS script provided with each version
  187.        of COM-AND.    The BBS script supports
  188.  
  189.        o    modem capable of autoanswer
  190.        o    Reliable use whether the modem reports true CD or no
  191.        o    Access by ID and password
  192.  
  193.         .. SYSOP assigns ID and passwords to grant access
  194.         .. two privilege levels
  195.         .. time limited access for non-privileged IDs
  196.         .. the BBS supports a 'registration' function which could
  197.            automatically post a new ID/password, but does not now
  198.  
  199.        o    Comments to SYSOP from callers
  200.        o    SYSOP posted bulletins
  201.        o    Public and private mail
  202.        o    File upload and download
  203.  
  204.         .. WXMODEM, XMODEM, YMODEM, ZMODEM, and KERMIT
  205.         .. Uploads are not included in time limit computation
  206.  
  207.        o    SYSOP-to-caller chat mode (initiated by SYSOP)
  208.  
  209.        The BBS script is interpreted by COM-AND.  Therefore, it is not as
  210.        fast as a compiled program.    However, the speed of the COM-AND in-
  211.        terpretor is sufficient for this application on most modern PCs.
  212.  
  213.        The BBS script does not intend to provide a full fledged Bulletin
  214.        Board host.    It has been, and is now a work in progress.  Comments
  215.        and suggestions are welcomed.
  216.  
  217.  
  218.  
  219. Version 1.2: 921012
  220.  
  221. COM-AND Scripted BBS                             Page   2
  222.  
  223.  
  224. II.    Installation
  225.  
  226.  
  227.     Included with the BBS script are two utility scripts, one for BBS
  228.     setup and one for BBS file maintenance.  The BBSETUP script should be
  229.     run BEFORE BBS is loaded, of course.  However, we suggest you create
  230.     a subdirectory for the BBS on disk first.
  231.  
  232.     The BBS script (as well as BBSETUP and BBMAINT) default to the sub-
  233.     directory \BBS for the main BBS subdirectory.  The default name for
  234.     the main subdirectory may be overridden through BBSETUP.
  235.  
  236.     A. Create a subdirectory \BBS
  237.  
  238.        From the DOS prompt, from the drive you wish to use for BBS, type:
  239.  
  240.         "d>" MD \BBS
  241.  
  242.        As noted above, ANY name may be used for the main subdirectory.
  243.        [In the following discussion \BBS represents the main subdirec-
  244.        tory, whatever it may be named.] The "d>" above represents the
  245.        DOS prompt.    Copy the BBS script(s), BBSETUP, BBMAINT, BBMAINT1,
  246.        BBMAINT2, BBMAINT3, and BBMAINT4 to this subdirectory:
  247.  
  248.         "d>" COPY BB*.* \BBS\*.*
  249.  
  250.     B. Load BBSETUP
  251.  
  252.        At this point, load COM-AND and invoke BBSETUP from the new sub-
  253.        directory.  For example, from the DOS prompt:
  254.  
  255.          "d>" COM-AND /f\BBS\BBSETUP
  256.  
  257.        loads COM-AND and invokes BBSETUP from the \BBS subdirectory.
  258.        It is important you execute BBSETUP FROM the BBS main subdirec-
  259.        tory the first time, as BBSETUP creates a parametrization file
  260.        for BBS best residing on that subdirectory.    The file BBSETUP
  261.        creates is named BBSDAT.  BBSDAT is placed by BBSETUP:
  262.  
  263.        1) If BBSDAT does not exist on the default subdirectory, on the
  264.           subdirectory indicated by the COM-AND= environment variable,
  265.           OR on the subdirectory from which BBSETUP executes, it is
  266.           created on the subdirectory from which BBSETUP was executed.
  267.  
  268.        2) If BBSDAT exists in any of the above mentioned three places,
  269.           preference in the order given, it is overwritten there.
  270.  
  271.  
  272.  
  273.  
  274. Version 1.2: 921012
  275.  
  276. COM-AND Scripted BBS                             Page   3
  277.  
  278.  
  279. II.    Installation (continued)
  280.  
  281.  
  282.     C. Use BBSETUP to identify values for use by the BBS
  283.  
  284.        From BBSETUP's main menu, select the items in numeric order.
  285.  
  286.        1) Identify subdirectories used by BBS;        Do this 1st!
  287.  
  288.           a) Identify BBS main subdir; Regardless of the subdirectory
  289.          from which BBSETUP executes, the first time BBSETUP is
  290.          used, it shows: \BBS.    Change this value as needed.
  291.  
  292.           b) Identify BBS Files subdir; This defaults to \BBS\FILES.  It
  293.          may be placed anywhere.  [It need not be related to the main
  294.          main subdirectory, or even on the same disk!]    The subdirec-
  295.          tory may not even exist... it may be created (below).
  296.  
  297.           c) Identify BBS Mail subdir; This defaults to \BBS\MAIL. See
  298.          notes to 1)b above.
  299.  
  300.           d) Identify BBS Bulletins subdir; Default is to \BBS\BULLETIN.
  301.          See notes to 1)b above.
  302.  
  303.  
  304.        2) Create BBS subdirectories and files;        Do this 2nd!
  305.  
  306.           Once the above subdirectories have been identified, select this
  307.           item from the BBSETUP main menu.    If any of the subdirectories
  308.           identified in the first step do not exist, they are listed, and
  309.           you are asked if they are to be created.
  310.  
  311.  
  312.        3) Identify modem values                Finally...
  313.  
  314.           a) Identify modem port; The default value is the default for
  315.          COM-AND.  You may wish to change this for the BBS.  Whatever
  316.          port you indicate here becomes the BBS's communication port.
  317.  
  318.           b) Identify modem speed; The default value is the default for
  319.          COM-AND.  You may wish to change this for the BBS.  This is
  320.          the speed set by the BBS when waiting for a call.
  321.  
  322.           c) Identify modem control string;  The default value for this
  323.          is appropriate for most Hayes compatible modems.  It may
  324.          need modification for some modems; if so, refer to the
  325.          modem's documentation.
  326.  
  327.  
  328.  
  329. Version 1.2: 921012
  330.  
  331. COM-AND Scripted BBS                             Page   4
  332.  
  333.  
  334. II.    Installation (continued)
  335.  
  336.  
  337.     D. Exit BBSETUP and load BBMAINT
  338.  
  339.        ESC or successive carriage returns exits BBSETUP.  Once back in
  340.        COM-AND, invoke BBMAINT through the F2 key.    In the script prompt
  341.        window, for example, type:
  342.  
  343.         \BBS\BBMAINT
  344.  
  345.        [Execute BBMAINT from the main subdirectory for the BBS.]  The
  346.        BBMAINT script is used to maintain (and create) the control files
  347.        used by BBS.  The only file you MUST be alter before BBS is used
  348.        the first time is the User file.  There must be at least ONE user
  349.        ID for logon!
  350.  
  351.        The BBMAINT script performs the following functions:
  352.  
  353.        1) Update BBS User file
  354.  
  355.           a) Add an ID
  356.           b) Delete an ID
  357.           c) Modify an ID's values
  358.           d) Print User list
  359.           e) View list of IDs
  360.  
  361.        2) Update BBS File directory
  362.  
  363.           a) Add a file to the up/download list [NOTE: The file being
  364.          listed should reside on the Bulletin subdirectory before it
  365.          is added.  It does not HAVE to exist there, but it should.]
  366.           b) Delete a file from the list
  367.           c) Modify a file's listing
  368.           d) Print a file list
  369.           e) View the file list
  370.  
  371.        3) Update BBS Mail listing
  372.  
  373.           a) Clean up mail directory
  374.           b) Delete notes older than ...
  375.           c) Read notes newer than...
  376.           d) Post a new note
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384. Version 1.2: 921012
  385.  
  386. COM-AND Scripted BBS                             Page   5
  387.  
  388.  
  389. II.    Installation (continued)
  390.  
  391.  
  392.     D. Exit BBSETUP and load BBMAINT (continued)
  393.  
  394.        4) Update BBS Bulletin listing
  395.  
  396.           a) Add a bulletin to the list.  [NOTE:  The file containing the
  397.          bulletin should reside on the Bulletin subdirectory before
  398.          it is added.  It does not HAVE to exist, but it should.]
  399.           b) Delete a bulletin from the list
  400.           c) Modify a bulletin's listing
  401.           d) Print a bulletin list
  402.           e) View the bulletin list
  403.  
  404.  
  405.     E. Execute BBS
  406.  
  407.        Two BBS script files are included in each release.  The script
  408.        BBS.SRC is commented source for the BBS.  The file BBS.CMD is a
  409.        stripped script; it contains no comments and is not very readable.
  410.        BBS.CMD is the script you execute.  Stripped, it executes much
  411.        faster than BBS.SRC.  BBS.SRC is provided for the intrepid who
  412.        wish to modify the BBS.
  413.  
  414.  
  415.        For example, in COM-AND, from the F2 script prompt window, type:
  416.  
  417.         \BBS\BBS
  418.  
  419.        [COM-AND does not recognize BBS.SRC as a script unless the ".SRC"
  420.        extension is explicit.] Again, execute the BBS from the BBS main
  421.        subdirectory, to allow BBS to find the BBSDAT file created by
  422.        BBSETUP.
  423.  
  424.  
  425.        Having loaded BBS, we suggest you then call in from another
  426.        PC and test the setup.
  427.  
  428.  
  429.        Should the use of BBS become a habit (horrors!), a simple batch
  430.        file may be used to invoke it from the DOS prompt:
  431.  
  432.         COM-AND /q/f\BBS\BBS
  433.  
  434.        [The /q inhibits COM-AND's automatic execution of COM-AND.CMD, if
  435.        one exists.    COM-AND.CMD's pausing for entry (some do, some don't)
  436.        are difficult to use in batch mode.]
  437.  
  438.  
  439. Version 1.2: 921012
  440.  
  441. COM-AND Scripted BBS                             Page   6
  442.  
  443.  
  444. III.    Logon
  445.  
  446.  
  447.     Callers to this BBS must be identified through and ID and password
  448.     in the BBS-User file.  You add and delete IDs and passwords
  449.     through the BBMAINT script.
  450.  
  451.  
  452.     New callers may 'register'... their name, address, telephone and
  453.     requested ID/password are logged to the BBS-NOTE file (created by
  454.     BBS in the main subdirectory when comments are posted) for review.
  455.  
  456.  
  457.     Two privilege levels are supported at this time.  Non-privileged
  458.     callers are granted 60 minutes of connect time per call.  Privileged
  459.     users are granted unlimited connect.  Note: non-privileged users may
  460.     call back.  The BBS does not record time used across a day.
  461.  
  462.  
  463.     A non-privileged user has the ability to upload files (to the BBS
  464.     files subdirectory) and download files (from the BBS files subdirec-
  465.     tory).    A non-privileged user may read bulletins not marked 'privi-
  466.     leged', may read mail addressed to themselves or ALL, and may
  467.     write mail to any ID.
  468.  
  469.  
  470.     A privileged user has the ability to upload files to any legitimate
  471.     subdirectory and download files from any legitimate subdirectory.
  472.     A privileged user may read any posted bulletins, may read mail
  473.     address any ID, and may write mail to any ID.
  474.  
  475.  
  476.     In addition, the privileged user has access to a 'Privileged' menu of
  477.     functions (from the main menu).  The menu provides:
  478.  
  479.     o    Listing of files on any subdirectory
  480.     o    Changing the default subdirectory (temporarily... this change
  481.         only holds during the 'Privileged' menu)
  482.     o    Listing the subdirectory tree from any disk (using the TREED
  483.         utility, public domain, not supplied with this script)
  484.     o    Shell to DOS on the host machine and execute single DOS
  485.         command lines (BE VERY CAREFUL - this can be fatal to BBS!)
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494. Version 1.2: 921012
  495.  
  496. COM-AND Scripted BBS                             Page   7
  497.  
  498.  
  499. IV.    Bulletins
  500.  
  501.  
  502.     Bulletins are files displayed to the caller on request from the
  503.     B)ulletin menu of BBS.    Bulletins are identified to the BBS through
  504.     the BBS-BULL file on the BBS Bulletins subdirectory.  This file is
  505.     maintained through Add/Delete/Modify bulletin functions of BBMAINT.
  506.  
  507.  
  508.     [Note: A bulletin file should exist on the Bulletins subdirectory
  509.     BEFORE it is added by BBMAINT.    If a bulletin file is listed but
  510.     does not exist, it does not appear in the listing given the caller.]
  511.  
  512.  
  513.     The B)ulletin submenu supports the following user commands:
  514.  
  515.     o    L)ist        List available bulletins
  516.     o    #        Read a specific bulletin
  517.  
  518.  
  519.     The list of available bulletins is taken from the file BBS-BULL.
  520.     Comments in the file are not printed for the caller to see.  Bull-
  521.     etin numbers may be arbitrarily assigned (and may even be alpha!).
  522.  
  523.  
  524.     Individual bulletins may be restricted to privileged callers only.
  525.  
  526.  
  527.     The caller selects a bulletin number to view from the list supplied.
  528.     The bulletin is transferred using an ASCII send function:  control-
  529.     S and control-Q may be used to suspend the transfer.
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549. Version 1.2: 921012
  550.  
  551. COM-AND Scripted BBS                             Page   8
  552.  
  553.  
  554. V.    Mail
  555.  
  556.  
  557.     Letters are files displayed to the caller on request from the M)ail
  558.     menu of BBS.  Mail files identified to the BBS through the BBS-MAIL
  559.     file on the BBS Mail subdirectory.  This file is maintained through
  560.     Cleanup/Delete-old functions of BBMAINT.
  561.  
  562.  
  563.     The M)ail submenu supports the following user commands:
  564.  
  565.     o    S)can        Scan postings for mail 'to' the caller
  566.     o    L)ist        List mail (to,from,date,subject)
  567.     o    N)ew        Read new mail (to caller, and public posts)
  568.     o    A)ll        Read all mail (to caller, and public posts)
  569.     o    W)rite        Write a message (public or private)
  570.  
  571.  
  572.     The list of pending mail is taken from the file BBS-MAIL.  Comments
  573.     in the file are not printed for the caller to see.  Mail is only
  574.     readable sequentially (at this time).  Mail is marked 'private' to
  575.     receiver when it is created (unless it is posted to the ID ALL).
  576.  
  577.  
  578.     The BBMAINT script provides two maintenance functions for mail.
  579.  
  580.     o    Cleanup: The clean function reconciles the BBS-Mail listing
  581.         against mail files actually existing.  Regular use of this
  582.         service speeds user access to mail.
  583.  
  584.     o    Delete: The delete function deletes letters older than a
  585.         given age (prompted).  It performs a cleanup function at the
  586.         same time.  [NOTE:  the age of retained letters is limited
  587.         to the start of the year before the current year.]
  588.  
  589.     o    Read: You may read posted notes (as sysop, you may read ALL
  590.         posted notes), and reply them while you read them.  When you
  591.         select 'reply' while reading a note, COM-AND's internal
  592.         editor is invoked to prepare the new text.
  593.  
  594.     o    Post: The may post a new note at any time.  COM-AND's
  595.         internal editor is invoked to prepare the new text.
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604. Version 1.2: 921012
  605.  
  606. COM-AND Scripted BBS                             Page   9
  607.  
  608.  
  609. VI.    Files (Upload and Download)
  610.  
  611.  
  612.     "Files" in this context are files displayed to the caller on request
  613.     from the F)iles menu of BBS.  Files are identified to the BBS through
  614.     the BBS-FILE file on the BBS Files subdirectory.  BBS-File is main-
  615.     tained through Add/Delete/Modify bulletin functions of BBMAINT, and
  616.     is also updated by the BBS script upon successful upload.
  617.  
  618.  
  619.     [Note: A file should exist on the Files subdirectory BEFORE it is
  620.     added by BBMAINT.  If a file is listed but does not exist, it does
  621.     not appear in the listing given the caller.  See also note below.]
  622.  
  623.  
  624.     The F)iles submenu supports the following user commands:
  625.  
  626.     o    L)ist        List available files
  627.     o    S)earch     Search the file list for a substring
  628.     o    U)pload     Upload a file (to the board)
  629.     o    D)ownload    Download a file (from the board)
  630.  
  631.  
  632.     Files may be uploaded and downloaded from this script using:
  633.  
  634.     o    WXMODEM (Windowed XMODEM)
  635.     o    XMODEM (CRC or checksum)
  636.     o    YMODEM (XMODEM 1-K, CRC or checksum)
  637.     o    ZMODEM
  638.     o    KERMIT (Windowed or plain)
  639.  
  640.  
  641.     Non-privileged callers are not allowed to upload files duplicating
  642.     files on the \BBS\Files subdirectory.  Non-privileged callers are
  643.     limited to downloading files (1) listed in BBS-File and (2) from the
  644.     Files subdirectory (not necessarily just those listed by the L)ist
  645.     display, but the caller must know the file is there).
  646.  
  647.  
  648.     Privileged callers may upload/download to/from any accessible disc
  649.     device and subdirectory, by specifically qualifying the file name.
  650.  
  651.  
  652.     Uploads are added at the end of the BBS-FILE file with a caller sup-
  653.     plied description, UNLESS the caller is privileged, AND the upload
  654.     is performed to a specific path.  When a file is uploaded to a spec-
  655.     ific subdirectory, no BBS-FILE entry is made.
  656.  
  657.  
  658.  
  659. Version 1.2: 921012
  660.  
  661. COM-AND Scripted BBS                             Page  10
  662.  
  663.  
  664. VI.    Files (continued)
  665.  
  666.  
  667.     Files listed through BBS-FILE may actually reside on any path or
  668.     drive.    By default, a file must exist on the \BBS\FILES subdirec-
  669.     tory.  However, if the description field of a BBS-File record begins
  670.     with ^A (control-a, not caret/letter-a), and if a second ^A is found
  671.     after it, the information in-between is used for pathing the file
  672.     specified.  In this manner, files listed in BBS-File may point to
  673.     from ANY drive or subdirectory.
  674.  
  675.  
  676.     For example, the description:
  677.  
  678.         xc:\prodxThis is a file description
  679.  
  680.     where 'x' on the screen is a 'happy face' (^A is represented as a
  681.     happy face on IBM PC compatible monitors) directs BBS to search for
  682.     the file on the "C:\PROD" drive and subdirectory.  The pathing does
  683.     NOT show to a caller of the BBS - the remainder of the description
  684.     (following the second ^A) is what is displayed.
  685.  
  686.  
  687.     When adding a file to BBS-FILE through BBMAINT, BBMAINT informs you
  688.     the file does not exist, and queries if it is to be added.  When a
  689.     file that BBMAINT cannot 'see' is added to BBS-FILE, its date and
  690.     size are set to "******".  When BBS sees the "*****"s, it replaces
  691.     the fields with the file's actual date and size.
  692.  
  693.  
  694.  
  695.     In this manner a file may be listed in BBS-FILE through BBMAINT
  696.     and THEN copied to the \BBS\FILES subdirectory.  [However, it is
  697.     recommended the file be copied there first, as a policy.]
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714. Version 1.2: 921012
  715.  
  716. COM-AND Scripted BBS                             Page  11
  717.  
  718.  
  719. VII.    Chat with SYSOP
  720.  
  721.  
  722.     The A)larm command at the main prompt sounds a tune on the local
  723.     console's speaker.  If the SYSOP wishes to respond the SYSOP may
  724.     interrupt the caller (whether the ALARM has been used or no) with
  725.     the ESCape key.
  726.  
  727.  
  728.     Pressing the ESCape key during the script's operation interrupts
  729.     the script; however, the caller is not disconnected immediately.
  730.     The SYSOP may choose to terminate the script (in which case a HANGUP
  731.     is performed).    The SYSOP may alternately choose to CHAT with the
  732.     caller.
  733.  
  734.  
  735.     When the SYSOP selects CHAT, the caller is informed of operator in-
  736.     tervention.  The SYSOP is prompted for a line of text (blank lines
  737.     entered by the SYSOP result in a query: "Continue" and are the means
  738.     for termination of the CHAT).  When the SYSOP presses CR, any text
  739.     is sent to the caller and the caller is prompted for text.  The chat
  740.     continues back and forth, one line at a time, until the caller
  741.     disconnects or the SYSOP terminates the chat.
  742.  
  743.  
  744.     At this time, time spent in CHAT is not added back to the caller's
  745.     total time alotment.
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769. Version 1.2: 921012
  770.  
  771. COM-AND Scripted BBS                             Page  12
  772.  
  773.  
  774. VIII.    Privileged access
  775.  
  776.  
  777.     Users flagged in the BBS-User file with privileged access are
  778.     provided an additional main menu subcommand ("P").  The "Privilege"
  779.     command gives access to a submenu with the commands:
  780.  
  781.  
  782.     o    L)ist       performs a DIR on the current subdirectory
  783.  
  784.     o    S)ubdir    changes the current drive:subdirectory;  This
  785.                holds only for the duration of the "Privilege"
  786.                menu.
  787.  
  788.     o    P)ath       provides a graphics display of the tree structure
  789.                of the current default disk (This requires the
  790.                public domain utility TREED.COM)
  791.  
  792.     o    D)os       performs a DOS command; BE WARY OF THIS FUNCTION!
  793.                A DOS command not returning immediately, such as,
  794.                say, 123, may halt the BBS.    Redirection is used
  795.                to display the results of the DOS command.
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824. Version 1.2: 921012
  825.  
  826. COM-AND Scripted BBS                             Page  13
  827.  
  828.  
  829. IX.    Menu Tree
  830.  
  831.  
  832.     A. Connect
  833.  
  834.        The Flying Scotsman greets you!
  835.  
  836.        The connect text, above, is issued if the file 'BBS-Welc' is not
  837.        found on the \BBS subdirectory.  If BBS-Welc is available, it is
  838.        transmitted instead (as an ASCII file).
  839.  
  840.     B. Logon
  841.  
  842.        Enter your ID (or enter GUEST):
  843.        Enter your password:
  844.  
  845.        The logon prompt, above, is issued after the connect welcome.  If
  846.        the response to the logon prompt is "GUEST", the caller is shunted
  847.        to "REGISTRATION" below (after which the caller is disconnected).
  848.        Any non-null response BUT "GUEST" to the logon prompt results in a
  849.        password prompt.  The password response, too, must be non-null. A
  850.        failed ID/Password pair is retried 3 times.
  851.  
  852.     C. Main menu
  853.  
  854.        C)omment, B)ulletins, M)ail, F)iles, A)larm or E)xit:
  855.  
  856.        The main menu text, above, is issued to a non-privileged caller if
  857.        the file 'BBS-NpMn' is not found on the \BBS subdirectory.  If
  858.        BBS-NpMn is available, it is transmitted instead.
  859.  
  860.        P)rivileged, C)omment, B)ulletins, M)ail, F)iles, A)larm or E)xit:
  861.  
  862.        The main menu text, above, is issued to a privileged caller if
  863.        the file 'BBS-PrMn' is not found on the \BBS subdirectory.  If
  864.        BBS-PrMn is available, it is transmitted instead.
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879. Version 1.2: 921012
  880.  
  881. COM-AND Scripted BBS                             Page  14
  882.  
  883.  
  884. IX.    Menu Tree
  885.  
  886.  
  887.     C. Main menu (continued)
  888.  
  889.        1. Comment
  890.  
  891.           Do you wish to leave a comment? (Y/N, cr=n):
  892.  
  893.           The comment prompt, above, is issued if the file 'BBS-NoMe' is
  894.           not found on the \BBS subdirectory.  If BBS-NoMe is available,
  895.           it is transmitted instead.  If the response is "y", the fol-
  896.           lowing queries are issued:
  897.  
  898.           Each line, as you enter it is recorded.  No edits, yet...
  899.           Enter a line/line(s) of text.  A blank line ends the note.
  900.           1:
  901.           2:
  902.           ...
  903.  
  904.        2. Bulletin
  905.  
  906.           L)ist, M)ain, E)xit, or a bulletin number:
  907.  
  908.           The bulletin submenu, above, is issued if the file 'BBS-BuMe'
  909.           is not found on the \BBS subdirectory.  If BBS-BuMe is avail-
  910.           able, it is transmitted instead.
  911.  
  912.           a) List: <no subcommands>
  913.           b) bulletin number: <no subcommands>
  914.  
  915.        3. Mail
  916.  
  917.           S)can, L)ist, N)ew, A)ll, W)rite, M)ain or E)xit:
  918.  
  919.           The mail submenu, above, is issued if the file 'BBS-MeMe' is
  920.           not found on the \BBS subdirectory.  If BBS-MeMe is available,
  921.           it is transmitted instead.
  922.  
  923.           a) SCAN: <no subcommands>
  924.           b) LIST: <no subcommands>
  925.           c) NEW:  <no subcommands>
  926.  
  927.          D)elete, R)eply, Q)uit (cr=continue):
  928.          - or -   R)eply, Q)uit (cr=continue):
  929.  
  930.          After each note is read, the above text prompts for
  931.          action.
  932.  
  933.  
  934. Version 1.2: 921012
  935.  
  936. COM-AND Scripted BBS                             Page  15
  937.  
  938.  
  939. IX.    Menu Tree
  940.  
  941.  
  942.     C. Main menu (continued)
  943.  
  944.        3. Mail (continued)
  945.  
  946.           d) ALL:  <no subcommands>
  947.  
  948.          After each note is read, the same prompts as for 'NEW'
  949.          (above) are issued.
  950.  
  951.           e) WRITE:
  952.  
  953.          To:
  954.          Subject:
  955.          Each line, as you enter it is recorded.  No edits, yet...
  956.          Enter a line/line(s) of text.    A blank line ends the text.
  957.          1:
  958.          2:
  959.          ...
  960.          Save? (Y/N, cr=y):
  961.          Private? (Y/N, cr=n):
  962.  
  963.        4. Files
  964.  
  965.           L)ist, S)earch, U)pload, D)ownload, M)ain or E)xit:
  966.  
  967.           The files submenu, above, is issued if the file 'BBS-FiMe' is
  968.           not found on the \BBS subdirectory.  If BBS-FiMe is available,
  969.           it is transmitted instead.
  970.  
  971.           a) LIST: <no subcommands>
  972.           b) SEARCH:
  973.  
  974.          Enter the search string:
  975.  
  976.           c) UPLOAD:
  977.  
  978.          Enter the file name:
  979.          W)xmodem, X)modem, Y)modem (X1k), Z)modem, or K)ermit:
  980.          Description:
  981.  
  982.           d) DOWNLOAD:
  983.  
  984.          Enter the file name:
  985.          W)xmodem, X)modem, Y)modem, Z)modem, K)ermit, or A)scii:
  986.  
  987.  
  988.  
  989. Version 1.2: 921012
  990.  
  991. COM-AND Scripted BBS                             Page  16
  992.  
  993.  
  994. IX.    Menu Tree
  995.  
  996.  
  997.     D. Privileged
  998.  
  999.        L)ist, P)ath, S)ubdir, D)OS, M)ain or E)xit:
  1000.  
  1001.        The privileged submenu, above, is issued if the file 'BBS-PpMn' is
  1002.        not found on the \BBS subdirectory.    If BBS-PpMn is available, it
  1003.        is transmitted instead.
  1004.  
  1005.        a) SUBDIR:
  1006.  
  1007.         Enter the drive:subdirectory:
  1008.  
  1009.        b) PATH:
  1010.  
  1011.         Pathlist command:
  1012.  
  1013.        c) DOS:
  1014.  
  1015.         Warning: this command may be used to invoke ANY COMMAND
  1016.         DOS can execute.  If you load a program requiring keyboard
  1017.         entry, you lock yourself out and leave the board unusable.
  1018.  
  1019.         Enter your command:
  1020.  
  1021.        d) DIR:
  1022.  
  1023.         Directory command:
  1024.  
  1025.     E. Registration
  1026.  
  1027.        Do you wish to register? (Y/N, cr=Y):
  1028.  
  1029.           The query, above, is issued if the file 'BBS-Reme' is not found
  1030.           on the \BBS subdirectory.  If BBS-Reme is found, its contents
  1031.           are transmitted instead.    On 'Y' entry:
  1032.  
  1033.        Enter your full name:
  1034.        Enter your street address:
  1035.        Enter your city/state and zip:
  1036.        Enter a area code and phone number where
  1037.        you may be reached:
  1038.        Enter the ID (1-8 chars) you wish to use:
  1039.        Enter the password (1-8 chars) you wish to use:
  1040.        Repeating your entry...
  1041.        Is this correct? (Y/N, cr=n):
  1042.  
  1043.  
  1044. Version 1.2: 921012
  1045.  
  1046. COM-AND Scripted BBS                             Page  17
  1047.  
  1048.  
  1049. X.    BBS-Log
  1050.  
  1051.  
  1052.     BBS activity is logged to a file BBS-Log on the \BBS subdirectory.
  1053.     BBS-Log is an ASCII file.  It may be printed with the DOS PRINT
  1054.     command.  The following events are logged:
  1055.  
  1056.  
  1057.     o   * BBS script loaded                 (also to calllog)
  1058.     o   * BBS cycled                    (also to calllog)
  1059.     o   * BBS script terminated                (also to calllog)
  1060.  
  1061.     o   <connect string from modem on connect, carries speed usually)
  1062.  
  1063.     o   Logon <ID>                        (also to calllog)
  1064.     o   Failed logon            (max number of attempts exceeded)
  1065.     o   Logoff <ID>                     (also to calllog)
  1066.  
  1067.     o   Upload: (x): <name>, Success            (x -> method)
  1068.     o   Uload of <name> succeeded, but BBS-FIle open failed
  1069.     o   Upload: (x): <name>, Failure            (x -> method)
  1070.  
  1071.     o   Download: (x): <name>, Success            (x -> method)
  1072.     o   Download: (x): <name>, Failure            (x -> method)
  1073.  
  1074.     o   Comment recorded
  1075.  
  1076.     o   Bulletin <number> read
  1077.  
  1078.     o   Registration aborted - disconn
  1079.     o   Registration declined by caller
  1080.     o   Registration requested
  1081.  
  1082.  
  1083.     If BBS-Log does not exist when the BBS script tries to write to the
  1084.     log, the file is created.  It is suggested you print the log regu-
  1085.     larly, and you delete the file afterwards.
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099. Version 1.2: 921012
  1100.  
  1101. COM-AND Scripted BBS                             Page  18
  1102.  
  1103.  
  1104. XI.    Program requirements
  1105.  
  1106.  
  1107.     COM-AND is coded for an IBM PC or DOS compatible machine.  COM-AND
  1108.     does direct to screen buffer fetches and stores (unless BIOS screen
  1109.     updates are directed using the /C switch or the Alt-O options menu).
  1110.  
  1111.  
  1112.     COM-AND is TopView aware even without the /C switch or Alt-O option.
  1113.  
  1114.  
  1115.     COM-AND supports MDA, CGA, EGA and Hercules.  COM-AND uses a Micro-
  1116.     soft Mouse if one is available...
  1117.  
  1118.  
  1119.     COM-AND disk I/O is done through the 'Handle' oriented I/O routines
  1120.     added to DOS 2.0.  Therefore DOS 2.0 is a minimum requirement.
  1121.  
  1122.  
  1123.     COM-AND (Version 2.9) requires 277K for itself.  You need 384K to
  1124.     take advantage of the DOS Gateway and to load accessories.
  1125.  
  1126.  
  1127.     This script requires a modem.  This script is most reliable if the
  1128.     modem is set to report true CD.
  1129.  
  1130.  
  1131.     And of course, for a Bulletin Board, you need alot of disk space!
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154. Version 1.2: 921012
  1155.  
  1156. COM-AND Scripted BBS                             Page  19
  1157.  
  1158.  
  1159. XII.    Author information
  1160.  
  1161.  
  1162.     COM-AND was written using Microsoft Macro-Assembler.  The author
  1163.     likes assembler.  Assembly language is an entirely appropriate
  1164.     vehicle for some of the program, and a not-inappropriate vehicle
  1165.     for the rest of it.  Everything, in moderation...
  1166.  
  1167.  
  1168.     The author of COM-AND and this script is R.  Scott McGinnis of
  1169.     Chicago, IL.  My GEnie and Delphi ID:  TARTAN.    Comment and
  1170.     suggestions (and criticism in moderation) are welcomed:
  1171.  
  1172.              CABER Software
  1173.              R. (Scott) McGinnis
  1174.              P.O. Box 3607 Mdse Mart
  1175.              Chicago, IL 60654-0607
  1176.  
  1177.  
  1178.     I want to thank Mike Todd (SYSOP of the IBM PC SIG on the late
  1179.     SOURCE, and then on UNISON) and John Poindexter for their valuable
  1180.     comments on the 2.1 version of COM-AND script language.  This BBS
  1181.     script was, in fact, created to test the script changes made for
  1182.     version 2.2 of COM-AND.  [The current version of the BBS requires
  1183.     COM-AND 2.9 or later!]
  1184.  
  1185.  
  1186.     I also thank my wife, Elizabeth, who laughs often (and smiles almost
  1187.     always, regardless).
  1188.  
  1189.  
  1190.     This script (Version 1.2) may be distributed freely (but it isn't
  1191.     a whole lot of use without COM-AND).  Any improvements returned to
  1192.     the author get attention...  errors reported to the author are
  1193.     corrected (if possible).  COM-AND is shareware.  If you USE COM-AND
  1194.     after a 30 day evaluation, you MUST pay for it.  [See REGISTER.DOC
  1195.     included with COM-AND for the user license.]
  1196.  
  1197.  
  1198.     Most of the hardware names and software names in this document are
  1199.     trademarks or trade names of specific manufacturers.
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209. Version 1.2: 921012
  1210.  
  1211. COM-AND Scripted BBS                             Page  20
  1212.  
  1213.  
  1214. XIII.    Support EtCetera BBS
  1215.  
  1216.  
  1217.     A version of this BBS script (constantly evolving) is maintained for
  1218.     COM-AND support and distribution by Support EtCetera in Long Beach,
  1219.     CA.  Support EtCetera supports, markets and distributes COM-AND
  1220.     (among other products).  The version of this script used by Support
  1221.     EtCetera provides instant access, after BBS registration.
  1222.  
  1223.  
  1224.     Mike Todd, the sysop of the BBS and President of Support EtCetera
  1225.     always has the most current release (or beta) of COM-AND available
  1226.     there.    Mike also makes the version of the BBS script he uses (con-
  1227.     siderably extended beyond the functions documented here) available
  1228.     as a Support EtCetera product.
  1229.  
  1230.  
  1231.     Mike was the founder of the Capitol PC User's Group, and the founder
  1232.     of the IBM SIG(s) on CIS, the SOURCE, and UNISON.  His experience
  1233.     with telecommunications is considerable!  COM-AND's script language
  1234.     itself owes much to Mike Todd's ever pushing the limits of COM-AND.
  1235.  
  1236.  
  1237.     Support EtCetera may be contacted:
  1238.  
  1239.     Voice:    (310) 439-6104
  1240.     BBS:    (310) 439-7714 (1200/2400 8n1)
  1241.  
  1242.     Mail:    Support EtCetera
  1243.         1 World Trade Center
  1244.         PO Box 32187
  1245.         Long Beach CA, 90832-2187
  1246.  
  1247.     UNISON: MIKETODD (PARTI: Mike Todd)
  1248.  
  1249.  
  1250.     Mike is always in contact with the author of COM-AND and up-to-date
  1251.     on COM-AND developments.  Many innovations in the use of COM-AND and
  1252.     COM-AND scripts are available first through the Support EtCetera BBS
  1253.     (and are Mike's suggestions, embodied, t'boot).  Having read this
  1254.     far, the author recommends you call Support EtCetera!
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264. Version 1.2: 921012
  1265.  
  1266. COM-AND Scripted BBS                             Page  21
  1267.  
  1268.  
  1269. A.    Required and optional files
  1270.  
  1271.     1. Required files in subdirectory \BBS
  1272.  
  1273.        BBS-USER           ID/Password file (created by BBSETUP/BBMAINT)
  1274.  
  1275.     2. Optional files in subdirectory \BBS
  1276.  
  1277.        BBS-NOTE           Comments/registrations - created if D.N.E
  1278.        BBS-LOG           Log of usage - created if D.N.E
  1279.        BBS-Welc           Welcome message
  1280.        BBS-NpMn           Non-privileged user main menu
  1281.        BBS-PrMn           Privileged user main menu
  1282.        BBS-PpMn           Privileged user privileged submenu
  1283.        BBS-NoMe           Message displayed when NOTE requested
  1284.        BBS-ReMe           Message displayed when REGISTER requested
  1285.        BBS-FiMe           All users: files submenu
  1286.        BBS-MeMe           All users: mail submenu
  1287.        BBS-BuMe           All users: bulletins submenu
  1288.  
  1289.     3. Optional files in subdirectory \BBS\Bulletin
  1290.  
  1291.        BBS-BULL           Points to available bulletins
  1292.                    (created by BBSETUP; updated by BBMAINT)
  1293.        BBS-BuMe           (may exist here as well) optional submenu
  1294.  
  1295.     4. Optional files in subdirectory \BBS\Mail
  1296.  
  1297.        BBS-MAIL           Points to existing and deleted messages
  1298.                    (created by BBS if it does not exist)
  1299.        BBS-MeMe           (may exist here as well) optional submenu
  1300.  
  1301.     5. Optional files in subdirectory \BBS\Files
  1302.  
  1303.        BBS-FILE           Points to files uploaded and downloadable
  1304.                    (created by BBSETUP; updated by BBMAINT)
  1305.        BBS-FiMe           (may exist here as well) optional submenu
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319. Version 1.2: 921012                          Appendices
  1320.  
  1321. COM-AND Scripted BBS                             Page  22
  1322.  
  1323.  
  1324. B.    File Structures
  1325.  
  1326.  
  1327.     1. \BBS\BBS-User            (User IDs/passwords)
  1328.  
  1329.        The BBS-User file is structured:
  1330.  
  1331.        0         8           16 17
  1332.        +---/ /---+---/ /---+--+---/ /---+---/ /---+---/ /---+
  1333.        ! ID      ! Passwd  !  ! Comments            !
  1334.        +---/ /---+---/ /---+--+---/ /---+---/ /---+---/ /---+
  1335.                    ^Privilege flag = P
  1336.  
  1337.        "<" in column 0 indicates a comment line; comments are ignored
  1338.  
  1339.     2. \BBS\Bulletin\BBS-BULL        (Bulletin items)
  1340.  
  1341.        The BBS-BULL file is structured:
  1342.        0         5           13 14        26
  1343.        +---/ /---+---/ /---+--+---/ /---+-------/ /--------+
  1344.        ! Number  ! Date    !  ! Fname   ! Subject (40 char)!
  1345.        +---/ /---+---/ /---+--+---/ /---+-------/ /--------+
  1346.                  ^Privileged access if nonblank
  1347.  
  1348.        "*" in column 0 indicates a comment line; comments not displayed
  1349.  
  1350.     3. \BBS\Mail\BBS-MAIL            (Mail items)
  1351.  
  1352.        The BBS-MAIL file is structured:
  1353.  
  1354.        0         8           16 17        25          38
  1355.        +---/ /---+---/ /---+--+---/ /---+---/ /---+-------/ /--------+
  1356.        ! To ID   ! From ID !  ! Date    ! Fname   ! Subject (40 char)!
  1357.        +---/ /---+---/ /---+--+---/ /---+---/ /---+-------/ /--------+
  1358.                 ^Privacy flag = P
  1359.  
  1360.        "*" in column 0 indicates a comment line; comments not displayed
  1361.  
  1362.     4. \BBS\File\BBS-FILE            (File items)
  1363.  
  1364.        The BBS-FILE file is structured:
  1365.        0         12        20 21        28
  1366.        +---/ /---+---/ /---+--+---/ /---+-------/ /--------+
  1367.        ! Fname   ! Date    !  ! Size    ! Description      !
  1368.        +---/ /---+---/ /---+--+---/ /---+-------/ /--------+
  1369.                  ^ Privilege req'd if non-blank
  1370.  
  1371.        "*" in column 0 indicates a comment line; comments are displayed
  1372.  
  1373.  
  1374. Version 1.2: 921012                          Appendices
  1375.  
  1376. COM-AND Scripted BBS                             Page  23
  1377.  
  1378.  
  1379. C.    Maintenance
  1380.  
  1381.  
  1382.     1. Registrations
  1383.  
  1384.        Registrations are not automatically entered into the BBS-User
  1385.        file.  The registrations exist as comments in the BBS-NOTE file.
  1386.        BBS-NOTE may be printed with the DOS PRINT or COPY commands.  A
  1387.        registering user is asked for a password and an ID.    IDs may not
  1388.        contain "."s, by the way.  The SYSOP must add a record to the
  1389.        BBS-User file to activate the ID (using the BBMAINT script).
  1390.  
  1391.     2. Mail
  1392.  
  1393.        The Mail routines depend on the file BBS-MAIL in the Mail sub-
  1394.        directory for finding messages.  When a letter is deleted the BBS
  1395.        script deletes the file.  BBS does not update the BBS-MAIL file
  1396.        upon letter deletion; rather, BBS detects a deleted file and
  1397.        skips the record.  BBMAINT may be used to cleanup BBS-MAIL.
  1398.  
  1399.     3. Bulletins
  1400.  
  1401.        If the file BBS-BULL does not exist on the Bulletin subdirectory,
  1402.        the caller is informed there are no bulletins.  BBS-BULL may be
  1403.        created and modified through the BBMAINT script.  Again, records
  1404.        in BBS-BULL not pointing to existing files are not displayed.
  1405.  
  1406.     4. Files (uploads and downloads)
  1407.  
  1408.        The file BBS-FILE in the subdirectory \BBS\FILES is automatically
  1409.        created upon the first upload.  However, comments in this file
  1410.        are displayed and may be used for informational purposes.  If you
  1411.        want these comments, they must be added manually.
  1412.  
  1413.        Please note the method described for listing files on subdirec-
  1414.        tories other than \BBS\FILES in the files directory.
  1415.  
  1416.        Add files to the listing with the BBMAINT script.  Uploads are
  1417.        always added at the end of the file by the BBS script.
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429. Version 1.2: 921012                          Appendices
  1430.  
  1431. COM-AND Scripted BBS                             Page  24
  1432.  
  1433.  
  1434. D.    Modem Configuration
  1435.  
  1436.  
  1437.     COM-AND default values do not require modem prefiguration (although
  1438.     you may choose to to it!).  However, certain features cannot be used
  1439.     unless you configure your modem before you use COM-AND.
  1440.  
  1441.  
  1442.     1. DTR (Data Terminal Ready)
  1443.  
  1444.        COM-AND, by default, hangs up using the command sequences defined
  1445.        through the Alt-S setup (hangup and modem escape).  However, you
  1446.        may alternately select 'Drop DTR to hangup' through the Alt-O
  1447.        options.  Dropping DTR is the only way to hangup certain modems,
  1448.        and is generally much faster than the command sequences.
  1449.  
  1450.  
  1451.        Most Hayes compatible modems allow configuration of the DTR sense
  1452.        through a switch-block.  If you wish to use DTR to hangup, be sure
  1453.        your modem follows the DTR signal.  Refer to the documentation
  1454.        provided with your modem to ensure modem switches are set
  1455.        appropriately.
  1456.  
  1457.  
  1458.     2. CD (Carrier Detect)
  1459.  
  1460.        COM-AND (presently) uses the CD sense line for several purposes.
  1461.        The 'CONNECTED' test supported in the script language, test for
  1462.        carrier detect upon exit, and the file transfer protocols all
  1463.        require the modem report carrier detect.  True carrier detect
  1464.        is the only way to determine if you are 'on-line' or 'off-line'.
  1465.  
  1466.  
  1467.        Many Hayes compatible modems are sold with a carrier detect
  1468.        override (in other words the modem reports carrier detect all the
  1469.        time).  When carrier detect is overridden, COM-AND cannot detect
  1470.        when carrier is lost during a file transfer or during a session.
  1471.  
  1472.  
  1473.        Be sure the modem is reporting true CD (instead of it just saying
  1474.        'yes').  Most Hayes compatible modems allow configuration of the
  1475.        CD sense through a switch-block.  Refer to the documentation
  1476.        provided with your modem to ensure modem switches are set
  1477.        appropriately.
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484. Version 1.2: 921012                          Appendices
  1485.  
  1486. COM-AND Scripted BBS                             Page  25
  1487.  
  1488.  
  1489. D.    Modem Configuration (continued)
  1490.  
  1491.  
  1492.     3. Modem Escape
  1493.  
  1494.        COM-AND issues the "Modem escape" defined through the Alt-S setup,
  1495.        prior to modem initialization and hangup.  Be sure this value is
  1496.        set correctly in Alt-S (or see below).
  1497.  
  1498.  
  1499.     4. Hangup
  1500.  
  1501.        COM-AND hangs up using the command sequences defined through the
  1502.        Alt-S setup (hangup and modem escape) and the drop DTR setting as
  1503.        discussed above.  Be sure these values are set correctly (or see
  1504.        below).
  1505.  
  1506.  
  1507.     5. Modem Init
  1508.  
  1509.        COM-AND transmits the modem initialization sequence defined by
  1510.        Alt-S setup to configure the modem.    BBS re-issues this initial-
  1511.        ization when BBS is exited.    If BBS is used, we suggest auto-
  1512.        answer be turned OFF in the Alt-S modem init string.
  1513.  
  1514.  
  1515.     6. Other settings
  1516.  
  1517.        The BBS sets its own values BEFORE executing the BBSDAT file (the
  1518.        BBSDAT is an executable script).  Therefore, you may override any
  1519.        COM-AND default settings by editing the BBSDAT file.  Have a care
  1520.        NOT to change variables already defined in BBSDAT!  When BBS is
  1521.        exited, a RESET statement is performed.
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539. Version 1.2: 921012                          Appendices
  1540.  
  1541. COM-AND Scripted BBS                             Page  26
  1542.  
  1543.  
  1544. E.    Sample files
  1545.  
  1546.  
  1547.     1. BBS-USER
  1548.        --------
  1549.  
  1550.     <------------------------------------------------------------------>
  1551.     <    Comment entries begin '<'; Case is not significant in IDs
  1552.     <    and passwords.    ID field begins in column 0.
  1553.     <
  1554.     <- ID ->< Pass >P<---------- Comments ----------------------------->
  1555.     Scott    xxxxxxxxP
  1556.  
  1557.     2. BBS-BULL
  1558.        --------
  1559.  
  1560.     ********************************************************************
  1561.     *    Comment entries begin '*'; Each entry points to a file (nnn).
  1562.     *    Each entry is numbered explicitly (###).
  1563.     ********************************************************************
  1564.     1     4/05/88 BULL.1      ISENGARD BBS's ANSI display
  1565.  
  1566.     3. BBS-MAIL (created automatically)
  1567.        --------
  1568.  
  1569.     ALL    SCOTT      4/06/88ALL.1          This board
  1570.  
  1571.     4. BBS-FILE (created automatically, but nice to post initially)
  1572.        --------
  1573.  
  1574.     ********************************************************************
  1575.     *
  1576.     *    Board related files
  1577.     *
  1578.     BBS.SRC      4/05/88           Source code w/comments for this BBS
  1579.     *
  1580.     *    Uploads...
  1581.     *
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594. Version 1.2: 921012                          Appendices
  1595.